Nogweii

  • A good RFC is quick and easy to fill out

    • Aim for a minimum number of questions/sections to fill out
    • The more people add/change a template, growing it, the less likely people will actually use it
  • Zero yes/no answers, or otherwise very simple 1-line answers.

    • Those can be put into a checklist instead. Checklists are good!
  • Example minimum structure:

    • Problem statement / why do we need to build something?
    • Goals of the system presented in design; non-goals which are out of scope
    • What success looks like, and how it can be measured
    • High-level overview of solution proposal
    • Details
    • Alternatives considered
    • Risks
  • Links:

  • This is part of an effort to provide good #documentation to allow a team to effectively collaborate.